---
title: Get Started with Chonkie
sidebarTitle: Quick Start
description: Get started with Chonkie
icon: "fast-forward"
iconType: "solid"
---

Using Chonkie takes two simple steps: First, install the package. Next, start chunking!

<Info>
  This page covers Chonkie Open Source. To get started with our API, visit the
  [API Reference](/api/common/introduction).
</Info>
## Installation

### Python

<CodeGroup>

```bash pip
pip install chonkie
```

```bash uv
uv add chonkie
```

</CodeGroup>

<Note>
  Want more features? Install everything with `pip install "chonkie[all]"`. See
  [Installation](/oss/installation) for more options.
</Note>

### JavaScript

Install the core package for local chunking

<CodeGroup>
```bash npm
npm install @chonkiejs/core
```

```bash pnpm
pnpm add @chonkiejs/core
```

```bash bun
bun add @chonkiejs/core
```

```bash yarn
yarn add @chonkiejs/core
```

</CodeGroup>

<Note>
  Chonkie JS provides local support for token and recursive chunking. Other
  chunkers and features are available through the API.
</Note>

## CHONK! 🦛✨

<CodeGroup>

```python Python
# First import the chunker you want from Chonkie
from chonkie import TokenChunker

# Initialize the chunker
chunker = TokenChunker() # defaults to using GPT2 tokenizer

# Here's some text to chunk
text = """Woah! Chonkie, the chunking library is so cool!"""

# Chunk some text
chunks = chunker(text)

# Access chunks
for chunk in chunks:
  print(f"Chunk: {chunk.text}")
  print(f"Tokens: {chunk.token_count}")
```

```javascript JavaScript
// First import the chunker you want from Chonkie
import { RecursiveChunker } from "@chonkiejs/core";

// Create a chunker
const chunker = await RecursiveChunker.create({
  chunkSize: 512,
  minCharactersPerChunk: 24,
});

// Chunk your text
const chunks = await chunker.chunk(
  "Woah! Chonkie, the chunking library is so cool!"
);

// Use the chunks
for (const chunk of chunks) {
  console.log(chunk.text);
  console.log(`Tokens: ${chunk.tokenCount}`);
}
```

</CodeGroup>
